home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / update.n < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. update(n)                  Tk Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      update - Process pending events and/or when-idle handlers     |
  12.  
  13. SYNOPSIS                                                           |
  14.      update ?idletasks?
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      This command is used to bring the entire  application  world
  20.      ``up  to  date.''  It  flushes  all  pending  output  to the
  21.      display,  waits for the server to process  that  output  and
  22.      return  errors  or events, handles all pending events of any
  23.      sort (including when-idle handlers), and repeats this set of
  24.      operations  until  there  are  no pending events, no pending
  25.      when-idle handlers, no pending output to the server, and  no
  26.      operations still outstanding at the server.
  27.  
  28.      If the idletasks keyword is specified as an argument to  the  |
  29.      command,  then  no new events or errors are processed;  only  |
  30.      when-idle idlers are invoked.  This causes  operations  that  |
  31.      are  normally  deferred,  such as display updates and window  |
  32.      layout calculations, to be performed immediately.             |
  33.  
  34.      The update idletasks command  is  useful  in  scripts  where  |
  35.      changes  have  been  made to the application's state and you  |
  36.      want those changes to appear  on  the  display  immediately,  |
  37.      rather  than waiting for the script to complete.  The update  |
  38.      command with no options is useful in scripts where  you  are  |
  39.      performing a long-running computation but you still want the  |
  40.      application to respond to user interactions;  if  you  occa-  |
  41.      sionally  call update then user input will be processed dur-  |
  42.      ing the next call to update.
  43.  
  44.  
  45. KEYWORDS
  46.      event, flush, handler, idle, update
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.